Previous Book Contents Book Index Next

Inside Macintosh: QuickDraw GX Objects /
Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference
Color Profile Functions / Retrieving and Replacing Profile Information


GXUnlockColorProfile

You can use the GXUnlockColorProfile function to allow QuickDraw GX to relocate, compress, or unload a color profile object that has been locked.

void GXUnlockColorProfile (gxColorProfile source);
gxColorProfile
A reference to the color profile to be unlocked.
DESCRIPTION
To directly edit the color profile, call GXLockColorProfile followed by GXGetColorProfileStructure; after editing, call GXUnlockColorProfile.

Once you call GXUnlockColorProfile, the profile data may be relocated and a pointer returned by GXGetColorProfileStructure may no longer be valid.

SPECIAL CONSIDERATIONS
To avoid fragmenting the QuickDraw GX heap, call the GXUnlockColorProfile function as soon as possible after calling GXLockColorProfile.

ERRORS, WARNINGS, AND NOTICES
Errors 
colorProfile_is_nil 
SEE ALSO
The GXLockColorProfile function is described in the previous section. The GXGetColorProfileStructure function is described next.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996